home *** CD-ROM | disk | FTP | other *** search
/ Microsoft Programmer's Library / Microsoft Programmer's Library (CD-ROM Database)(125-099-008)(Version 1.1a)(CDRM 162100)(1989).iso / README.DOC < prev    next >
Text File  |  1989-06-30  |  15KB  |  356 lines
  1. README.DOC      Microsoft Programmer's Library version 1.1      June 30, 1989
  2.  
  3.   This document covers topics not discussed in the Programmer's Library
  4.   printed documentation.  Please read it -- and your manual -- in their
  5.   entirety.
  6.  
  7.  
  8. TEXT EDITOR SUPPORT
  9.  
  10.   Although you can use Microsoft Programmer's Library with almost any type of
  11.   software, it is designed so that you can copy and paste into text-editor
  12.   and word-processor software ONLY.  If you try to copy and paste sample code
  13.   or text into other types of software (for example, CAD programs, software
  14.   tutorials) that expect specific keystroke responses, you will likely
  15.   experience problems.
  16.  
  17.   If Programmer's Library is popped up over a text-editor help screen or
  18.   system setup screen, Programmer's Library may enter "Unknown" mode.  This
  19.   is indicated by the word "Unknown" on the Programmer's Library title bar,
  20.   above the Main menu bar.  In "Unknown" mode, paste and date stamp are
  21.   enabled. We strongly recommend, however, that you refrain from attempting
  22.   to paste when "Unknown" is displayed.
  23.  
  24.  
  25. GENERAL NOTES
  26.  
  27. --MS-DOS 4.x
  28.   If you intend to use Microsoft Library products with MS-DOS 4.x, you must
  29.   use the MS-DOS CD-ROM Extensions version 2.1 (or higher).  To upgrade your
  30.   version of the MS-DOS CD-ROM Extensions, copy the MSCDEX.EXE program from
  31.   the Optinet disk packaged with PL 1.1, contact the manufacturer of your
  32.   CD-ROM drive or call Meridian Data at (408) 476-5858.
  33.  
  34. --Sample Code
  35.   Programmer's Library sample code is contained in ASCII text files in the 
  36.   \SAMPCODE directory on the Programmer's Library CD-ROM disc.  You can use 
  37.   your editor to copy and paste any of these directly into your program's 
  38.   source code independent of Programmer's Library.
  39.   --In the \SAMPCODE directory is a subdirectory called \ALDE_C.  This code
  40.     is shareware and has not been generated by Microsoft.
  41.  
  42. --Stand-alone operation
  43.   You can use Programmer's Library as a stand-alone program and still
  44.   incorporate its text and sample code into your own programs.  To do so,
  45.   copy the data you need into the Programmer's Library Clipboard (appending
  46.   as necessary), and save the Clipboard data as an ASCII text file.  Later,
  47.   you can call the ASCII text file you saved into your text editor.
  48.  
  49. --TSR operation
  50.   If you use Programmer's Library as a memory-resident program, load it into
  51.   your computer before loading your text editor or any other application and
  52.   unload it only after exiting any other programs that were subsequently
  53.   started.
  54.  
  55.   Programmer's Library may behave erratically if it is popped up after
  56.   another memory-resident program that was also popped up over your text
  57.   editor.  For best results, pop up only one memory-resident program at a
  58.   time.
  59.  
  60.   Load keyboard enhancement programs before loading Programmer's Library.
  61.   Load other memory-resident programs after Programmer's Library.
  62.  
  63.   We recommend that you edit your CONFIG.SYS file so that it assigns values
  64.   of at least:
  65.  
  66.          files = 15
  67.          buffers = 20
  68.  
  69. --Microsoft CD-ROM Extensions
  70.   For the most efficient interaction between Programmer's Libarary and the
  71.   MS CD-ROM Extensions, set the MSCDEX /M: buffers option to 10 (at a
  72.   minimum) or 12 (for best effect).  The following is a sample command line
  73.   that starts the Extensions with buffers set to 12:
  74.  
  75.     C:\> MSCDEX /D:MSCD001 /M:12
  76.  
  77.  
  78. SPECIFIC TEXT EDITOR AND WORD PROCESSOR NOTES
  79.  
  80. Brief
  81. --When Brief starts up, the default line length is 144 characters.  If the
  82.   cursor is at the beginning of an 80-character line and if another 80-
  83.   character line is pasted into Brief from Programmer's Library, then the
  84.   last 16 characters to be pasted will be lost.  We recommend that when you
  85.   start Brief you use the -lxxx switch to alter its default line length.  An
  86.   example command-line call is: b -p -c1,1,3,3 -l160 <Enter>
  87. --Be sure to start Brief with the "-p" command line switch (as shown above).
  88.   Doing so ensures that Programmer's Library and Brief do not try to write
  89.   to the same video page at the same time.
  90.  
  91. Microsoft QuickC
  92. --Turn on insert mode before pasting sample code into your own program.
  93. --QC 2.0: If you use the /h option with QC and are running Programmer's
  94.   Library in TSR mode, run the 43.COM program in the CD-ROM's \MSLIB
  95.   directory before starting QC.
  96.  
  97. Microsoft QuickBASIC
  98. --Turn off syntax checking AND turn on insert mode before pasting sample code
  99.   into your own program.  To pop up Programmer's Library, press the shift key
  100.   and THEN the Alt key.
  101. --QB 4.5: If you use the /h option with QB and are running Programmer's
  102.   Library in TSR mode, run the 43.COM program in the CD-ROM's \MSLIB
  103.   directory before starting QB.
  104.  
  105. Microsoft Word, version 2.0 and 3.0
  106. --Graphics mode not supported.  A beep sounds if you attempt to pop up
  107.   Programmer's Library over graphics mode.
  108.  
  109. Microsoft Word, version 3.1, 3.2, and 4.0
  110. --Programmer's Library will temporarily turn off graphics mode while it is
  111.   popped up.  Graphics mode will be turned on again when it is popped down.
  112.  
  113. Microsoft Word, version 5.0
  114. --Graphics mode not supported.  Before popping up Programmer's Library over
  115.   graphics mode, use the Alt-F9 key or the Options command to switch to text
  116.   mode.  The Alt-F9 key will return you to your previous mode when
  117.   Programmer's Library is popped down.
  118. --When setting up Word 5.0, you must choose the "safe keyboard support" option.
  119.  
  120. Microsoft Works
  121. --When pasting whole paragraphs into the header/footer, you must delete hard
  122.   carriage returns (<Enter>) and insert soft carriage returns (<Shift>-
  123.   <Enter>) in their place.
  124.  
  125. WordPerfect, version 4.2
  126. --Pasting lines that extend into the "hot zone" can cause WordPerfect to
  127.   prompt you for hyphen placement, and can cause the rest of the to-be-pasted
  128.   text to be "lost."  To avoid this situation, set your margins or columns at
  129.   least 80 characters apart.
  130.  
  131. WordPerfect, version 5.0
  132. --Programmer's Library will not pop up when you are in Print Preview mode.
  133. --If you redefine your default BLOCK mode toggle key default <Alt>-<F4>,
  134.   Programmer's Library will not know that BLOCK mode has been toggled, and
  135.   WordPerfect will ignore your paste.
  136.  
  137. XyWrite III
  138. --Follow the instructions that accompany the XyWrite documentation for
  139.   setting up XyWrite to run with memory-resident programs.  If you don't, you
  140.   will likely experience serious problems.
  141. --You must use the default command prompt "CM" in order for Programmer's
  142.   Library to "know" that it is to work with XyWrite III. For this reason, we
  143.   recommend that you don't reconfigure the XyWrite III command prompt.
  144. --Don't pop up Programmer's Library over XyWrite III help screens.
  145.  
  146. Wordstar Professional Release 4.0, and Release 5.0
  147. --Turn off Wordstar's special character-formatting symbols (^b, for bold, for
  148.   example) before Programmer's Library is popped up.
  149. --Paste from Programmer's Library only when Wordstar is in insert mode.
  150. --You must be using help levels 1, 2, or 3 for Programmer's Library to
  151.   "know" that it is working with Wordstar.
  152.  
  153. DisplayWrite 3 version 1.10 and DisplayWrite 4 version 1.0
  154. --Supported by Programmer's Library in their default configurations
  155.  
  156.  
  157. VIDEO DISPLAY NOTES
  158.  
  159.   To correctly use a Hercules graphics adapter with Microsoft Word and
  160.   Programmer's Library, the environment variable HERCGB102 must be set equal
  161.   to TRUE.  Place the following entry in your AUTOEXEC.BAT file:
  162.  
  163.            SET HERCGB102 = TRUE 
  164.  
  165.   If you have a Hercules graphics adapter and you use Microsoft Word, you
  166.   must use Word in character mode (all versions) if you intend to use
  167.   Programmer's Library.
  168.  
  169.   If you are using a monochrome monitor driven by a graphics video card, or
  170.   a gas plasma display, start Programmer's Library using the /b command line
  171.   switch.
  172.  
  173.   Programmer's Library uses the current video page to display data.
  174.   Occasionally, less well-behaved software will not inform the bios of what
  175.   video page it is using.  This may cause a conflict with Programmer's
  176.   Library, and Programmer's Library may appear not to be working.  If this is
  177.   true with your software, please check the manual for instruction on how to
  178.   make the first video page (page 0) the default.
  179.  
  180.   If you have any difficulty using Programmer's Library in 43- or 50-line
  181.   video modes, run the 43.COM program in the CD-ROM's \MSLIB directory before
  182.   popping up Programmer's Library.
  183.  
  184.  
  185. USING PROGRAMMER'S LIBRARY WITH A MOUSE
  186.  
  187.   If you use a Microsoft Mouse, we recommend that you upgrade your Microsoft
  188.   Mouse driver IF it is a version earlier than 6.25.  If you upgrade and if
  189.   you use the MOUSE.SYS driver, delete your earlier version of MOUSE.SYS and
  190.   replace it with the MOUSE.SYS driver that resides on the Programmer's
  191.   Library CD-ROM disc.  Likewise, if you use MOUSE.COM, delete your earlier
  192.   version and replace it with the MOUSE.COM that resides on the Programmer's
  193.   Library CD-ROM disc.
  194.  
  195.   If you use the Mouse Systems PC Mouse and have problems with mouse behavior
  196.   in Programmer's Library, be sure you are using an MSMOUSE driver version
  197.   later than 4.70.  We recommend that you always use the latest mouse driver
  198.   software.  Check with your mouse manufacturer about getting an update.
  199.  
  200.   Occasionally, your text editor's mouse cursor will be "frozen" on your
  201.   screen when you call up Programmer's Library.  In that case, you will see
  202.   another mouse cursor, which Programmer's Library controls, and which will
  203.   work properly.  When you pop out of Programmer's Library, your text editor's
  204.   mouse cursor will be "unfrozen," and the Programmer's Library mouse cursor
  205.   will disappear.
  206.  
  207.  
  208.  
  209. USING PROGRAMMER'S LIBRARY WITH MULTIPLE CD-ROM DRIVES
  210.  
  211.   Programmer's Library setup creates a file called MSL.INI.  This file
  212.   contains paths for each Microsoft Library product.  The paths assume that
  213.   each product is in the same logical disk drive as it was when you first ran
  214.   setup.  If you change the drive in which Microsoft Library products are to
  215.   be found, you must also change the appropriate path names in MSL.INI.
  216.  
  217.  
  218. MANUAL SETUP PROCEDURES
  219.  
  220.   If you encounter problems with the setup program or if you simply prefer to
  221.   set up manually, follow the procedures below, which assume the following
  222.   about your system configuration:
  223.  
  224.         Hard Drive is drive C:
  225.         CD-ROM Drive is drive D:
  226.  
  227.   1. On your hard drive, create a subdirectory called "MSLIB".
  228.  
  229.                 C:\>md MSLIB <Enter>
  230.  
  231.   2. Change to the MSLIB subdirectory by typing "cd MSLIB" and ENTER.
  232.  
  233.                 C:\>cd MSLIB <Enter>
  234.  
  235.   3. Place the Programmer's Library CD-ROM disc in your D: drive.
  236.  
  237.   4. Copy all files in the MSLIB directory on drive D: (your CD-ROM
  238.      drive) to the MSLIB directory on drive C.
  239.  
  240.                 C:\MSLIB>copy d:\MSLIB\*.* <Enter>
  241.  
  242.   5. With your text editor, create an ASCII text file named MSL.INI, which
  243.      should look like this:
  244.  
  245. [msl]
  246.         os2,     OS/2 References,     D:\BOOKS, 2011
  247.         windows, Windows References,  D:\BOOKS, 2012
  248.         net,     Network References,  D:\BOOKS, 2013
  249.         msdos,   MS-DOS References,   D:\BOOKS, 2014
  250.         msj,     MS Systems Journal,  D:\BOOKS, 4015
  251.         hw,      Hardware References, D:\BOOKS, 4016
  252.         c,       C References,        D:\BOOKS, 2017
  253.         masm,    MASM References,     D:\BOOKS, 2018
  254.         basic,   BASIC References,    D:\BOOKS, 2019
  255.         pascal,  Pascal References,   D:\BOOKS, 2020
  256.         fortran, FORTRAN References,  D:\BOOKS, 2021
  257.  
  258.   6. From the MSLIB directory on drive C:, type "MSL" to load Programmer's 
  259.      Library and to run it as a standalone application.
  260.    
  261.              C:\MSLIB>msl <Enter>
  262.  
  263.      To load Programmer's Library and run it as a memory-resident program,
  264.      type:
  265.  
  266.              C:\MSLIB>msl -t <Enter>
  267.  
  268.  
  269.   See Appendix A in the User's Manual for more information on the individual
  270.   fields and format of the MSL.INI file.
  271.  
  272.  
  273. ERROR MESSAGES
  274.  
  275.   When you use the following commands, your work may be interrupted by an
  276.   error message.  If so, the following instructions will help you deal with
  277.   its associated problem.
  278.  
  279.  
  280. CROSSREF, FIND, AND QUICKREF ERROR MESSAGES
  281.  
  282. Error message: "Too many cross-references"
  283. --Choose the OK button or press <Enter>.
  284. --You have exceeded cross-reference capacity.  Save your current cross-
  285.   reference location with a bookmark, choose View Bookmark, and then select
  286.   the bookmark you just created.  This procedure clears the previous cross-
  287.   references you've viewed.
  288.  
  289. Error message: "Unable to find datafiles"
  290. --Choose the OK button or press <Enter>.
  291. --Be sure the Programmer's Library disc is in your CD-ROM drive.
  292.  
  293.  
  294. SEARCH ERROR MESSAGES
  295.  
  296. Error message: "No terms specified in search"
  297. --Choose the OK button or press <Enter>.
  298. --Enter the word or phrase you want to search for in the Term box 
  299.   and restart your search.
  300.  
  301.  
  302. Error message: "Too many high frequency words.  Search canceled"
  303. --Choose the OK button or press <Enter>.  
  304. --Try redefining your search by using either fewer words in the Term 
  305.   boxes or by using more specific words.
  306.  
  307.  
  308. BOOKMARKS ERROR MESSAGES
  309.  
  310. Error message: "Can't save updated bookmark list"
  311.   "      "   : "Can't open bookmark file for updating"
  312.   "      "   : "Can't add any more bookmarks, delete one first" 
  313.   "      "   : "Couldn't save bookmark file" 
  314.   "      "   : "Couldn't open bookmark file"
  315.   "      "   : "Bookmark not saved"
  316.  
  317. --Choose the OK button or press <Enter>.
  318.  
  319.   If any of the above messages appears, one of the following problems
  320.   exists:
  321.   --You have reached the bookmark capacity limit.  Delete unnecessary 
  322.     bookmarks.
  323.   --You have insufficient disk space on your computer.  Exit
  324.     Programmer's Library and delete unnecessary files on your disk.
  325.   --You have made your bookmark file (BKMARKS.INF) read-only.  Exit
  326.     Programmer's Library, be sure you are in your \MSLIB directory,
  327.     and then type:
  328.       
  329.            Attrib -r bkmarks.inf <Enter>
  330.  
  331.   --You do not have enough files specified in your CONFIG.SYS file.
  332.     Exit Programmer's Library, and edit CONFIG.SYS to specify a larger
  333.     "FILES =" value.
  334.  
  335. Error message: "Product not found"
  336. --Choose the OK button or press <Enter>.
  337. --Be sure an installed Microsoft CD-ROM Library disc is inserted in your
  338.   CD-ROM drive.
  339.  
  340.  
  341. "RE-RUN SETUP" 
  342.  
  343.   When a file necessary to Programmer's Library operation is corrupted or
  344.   deleted, an error message prompts you to rerun setup.  First, delete the
  345.   file "MSL.VER", and then rerun setup for the product that was being used
  346.   when the error message was produced.  If you are using more than one CD-ROM
  347.   disc (for example, Programmer's Library, Small Business Consultant, and
  348.   Stat Pack) and you encounter another "rerun setup" error message, then
  349.   repeat the procedure for the disc that you were using when you encountered
  350.   the message.
  351.  
  352.  
  353. TRADEMARKS
  354.  
  355.   Mouse Systems and PC Mouse are trademarks of Mouse Systems Corporation.
  356.